home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / devel / lang / lisp / akcl.rea < prev    next >
Encoding:
Text File  |  1996-11-16  |  4.0 KB  |  114 lines
  1.                     Padova, 1993 Mar 9
  2.  
  3.  
  4. This directory contains the following files:
  5.  
  6. akcl-1-615.tar.z  : AKCL from University of Texas, original file.
  7.           Compressed with gzip to save space.
  8.  
  9. kcl.tar.z         : KCL, original file compressed with gzip.
  10.  
  11. akcl-linux.tar.z  : Changes to compile akcl under linux. Works with 
  12.           linux 0.99pl2, gcc-2.3.3, libc-4.3.3 (and probably any other
  13.           version of linux)
  14.  
  15. akcl-bin.tar.z    : Binaries of akcl-1-615, compiled with gcc-2.3.3,
  16.       libc-4.3.3 and -m486 -O2.
  17.  
  18.  
  19. HOW TO USE THE BINARIES:
  20. ------------------------
  21.  
  22. Simply extract akcl-bin.tar.z in the root directory; it will create
  23. a script in /usr/local/bin and a directory /usr/local/akcl with
  24. the executable program and on-line documentation. Paths are hardwired,
  25. any change requires recompilation.
  26.  
  27. HOW TO RECOMPILE THE SOURCES:
  28. -----------------------------
  29.  
  30. First, make sure you have a lot of disk space (25Mb if you want
  31. to compile with -g, or 20Mb normal). 
  32.  
  33. The installation process is complicated by the fact I wanted to
  34. keep all the original files, in order to easily port new versions
  35. of akcl to linux; the authors of akcl (who derived it from kcl)
  36. thought the same way, and so the sources are split in three parts:
  37. kcl, akcl and the linux stuff. Consequently, you must choose
  38. three paths which will also contain the installation:
  39.  
  40. KCLDIR [ suggested /usr/local/kcl ] to keep the kcl sources.
  41. AKCLDIR [ suggested /usr/local/akcl ] to keep the akcl sources.
  42. LINUXDIR [ a temporary path, even /usr/tmp ] to keep the linux patches.
  43.  
  44. Then
  45.  
  46. mkdir $KCLDIR $AKCLDIR $LINUXDIR
  47.  
  48. Extract kcl.tar.z in $KCLDIR, akcl-1-615.tar.z in $AKCLDIR and
  49. akcl-linux.tar.z in $LINUXDIR. Then
  50.  
  51. cd $AKCLDIR
  52. cp -r $LINUXDIR/* .
  53. ./add-defs linux $KCLDIR
  54. nohup make -f Smakefile &
  55.  
  56. After a good amount of time (3-4 hours) and a lot of disk activity
  57. you should get a file $AKCLDIR/unixport/saved_kcl which can be stripped
  58. if you don't plan to use (si::faslink), which you probably shouldn't
  59. because it's implementation dependent. Please remark that CLX
  60. requires (si::faslink).
  61. saved_kcl is the main akcl executable, and contains the lisp interpreter
  62. and the compiler. The compiler produces C code, so you must also
  63. keep gcc installed if you want to use it. As root,
  64.  
  65. make install
  66.  
  67. will copy a script in /usr/local/bin which executes $AKCLDIR/unixport/saved_kcl,
  68. and some emacs files which will allow you to browse the documentation.
  69.  
  70.  
  71. WHAT TO DO IN CASE OF TROUBLE:
  72. ------------------------------
  73.  
  74. AKCL is a big program and it is not easy to find bugs; I tried to
  75. keep things as clean as possible, and used akcl on linux quite a lot
  76. getting even maxima compiled; so I am pretty convinced it runs
  77. very well. Despite this fact, if you encounter problems, please
  78. try to identify and solve them yourself: I really have not too
  79. much time to devote to maintain this software. Only if disperate,
  80. send mail to me. Anyway, I'll be glad to hear of any bugs
  81. or difficulties pertaining to akcl.
  82.  
  83. FINAL CONSIDERATIONS:
  84. ---------------------
  85.  
  86. The compiler, compiled by an interpreted compiler, produces a slightly
  87. different code than the compiler compiled by a compiled copy of itself. 
  88. This fact is true also on the sparc version of AKCL (I tried it).
  89. Anybody knows why ?
  90.  
  91. The directory $AKCLDIR/mp contains some multi-precision code derived
  92. from PARI-1.34. For some reason I could not realize, it does not work
  93. on linux --- the code contains some assembly parts which, even if
  94. 386-specific, don't work. The bug is still there; I replaced the
  95. defective files with some code stolen from PARI-1.35, with permission
  96. of the author, Mr. Cohen. It is in the file mpi-linux.c .
  97. The new code is pure C, so I expect it to be slower than the original,
  98. if it worked; I heard from the author of PARI that a linux port
  99. of pari-1.37, higly optimized for the 386, exists. If anybody
  100. can spend some time in incorporating the new code in akcl, I'll
  101. like to get the fixes to release an improved version of the files.
  102.  
  103. --------------------------------------
  104. Send comments, notes, bugs to
  105.  
  106. Matteo Frigo
  107. Via A. Fusinato 27
  108. 35137 PADOVA (PD)
  109. ITALY
  110.  
  111. e-mail: Matteo.Frigo@dei.unipd.it
  112.  
  113.  
  114.